home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / scsiha.z / scsiha
Encoding:
Text File  |  2002-10-03  |  15.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiiihhhhaaaa((((1111mmmm))))                                                          ssssccccssssiiiihhhhaaaa((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsiha - probe and control scsi buses
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssccccssssiiiihhhhaaaa [----llllpppprrrrttttTTTTwwwwssss] [----DDDD _d_e_b_u_g_l_e_v_e_l] [----LLLL _t_a_r_g_e_t_I_D|aaaallllllll]
  13.             [----SSSS _t_a_r_g_e_t_I_D|aaaallllllll] {_b_u_s__n_u_m_b_e_r | _d_e_v_i_c_e} ...
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _s_c_s_i_h_a is used to perform operations on fibrechannel loops of SCSI
  17.      devices and parallel SCSI buses.
  18.  
  19.      The following options apply to both parallel SCSI and fibrechannel SCSI:
  20.  
  21.      ----pppp   Probe for devices on the bus or loop.  On parallel SCSI buses, this
  22.           option causes the driver to look for devices at every ID on the SCSI
  23.           bus.  On fibrechannel SCSI loops, this option causes the driver to
  24.           look for devices at every ID that was reported in use at the most
  25.           recent loop initialization.  On parallel SCSI buses, when a device
  26.           is found at lun 0, all other luns are then probed.  When devices or
  27.           luns are not valid, a warning message may be printed on the console.
  28.           With fibrechannel, the Report Luns SCSI command is used to determine
  29.           which LUNs are valid.  If the Report Luns command returns error,
  30.           only LUN 0 is assumed to be valid.
  31.  
  32.           After probing, new devices will have a controller number of "-1"
  33.           until iiiiooooccccoooonnnnffffiiiigggg ----ffff ////hhhhwwww is run to update the hardware graph.
  34.  
  35.      ----rrrr   Perform a SCSI bus reset and/or reset host adapter.
  36.  
  37.           TTTThhhhiiiissss aaaaffffffffeeeeccccttttssss aaaallllllll ddddeeeevvvviiiicccceeeessss oooonnnn tttthhhhaaaatttt SSSSCCCCSSSSIIII bbbbuuuussss,,,, ccccaaaauuuussssiiiinnnngggg ccccuuuurrrrrrrreeeennnntttt ccccoooommmmmmmmaaaannnnddddssss
  38.           ttttoooo bbbbeeee aaaabbbboooorrrrtttteeeedddd,,,, aaaannnndddd ssssppppeeeecccciiiiaaaallllllllyyyy sssseeeetttt ppppaaaarrrraaaammmmeeeetttteeeerrrrssss ttttoooo bbbbeeee rrrreeeesssseeeetttt,,,, iiiinnnn mmmmaaaannnnyyyy
  39.           ccccaaaasssseeeessss....  TTTTaaaappppeeee ddddrrrriiiivvvveeee ssssttttaaaatttteeee wwwwiiiillllllll bbbbeeee rrrreeeesssseeeetttt aaaafffftttteeeerrrr tttthhhhiiiissss,,,, aaaannnndddd aaaannnnyyyy ttttaaaappppeeee
  40.           ooooppppeeeerrrraaaattttiiiioooonnnnssss iiiinnnn pppprrrrooooggggrrrreeeessssssss wwwwiiiillllllll bbbbeeee aaaabbbboooorrrrtttteeeedddd.
  41.  
  42.           This option should therefore be used with some caution.  In very
  43.           rare cases, it may cause a device to become unusable without a
  44.           powercycle.  There are times when it is desired to reset devices or
  45.           adapters that appear to be hung, however, so this function is
  46.           provided.  Some host adapter drivers will reset the adapter as part
  47.           of this ioctl.  Fibrechannel adapters will perform loop
  48.           initialization, making this operation similar to the ----llll option,
  49.           except that the adapter will also be reset.
  50.  
  51.      ----DDDD _d_e_b_u_g_l_e_v_e_l
  52.           Set the debug level in the host adapter driver.  Where supported,
  53.           this option changes the verbosity of a given host adapter driver.
  54.           In general, 0 is least verbose, with no specific upward limit.
  55.  
  56.      The following option only applies to some parallel SCSI adapters:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssccccssssiiiihhhhaaaa((((1111mmmm))))                                                          ssssccccssssiiiihhhhaaaa((((1111mmmm))))
  71.  
  72.  
  73.  
  74.      ----tttt   Return interesting SCSI bus and attached target parameters. Bus
  75.           parameters include whether the bus is single-ended or differential,
  76.           the SCSI host ID and the selection timeout. The target parameters
  77.           include whether the device is capable of operating in narrow or wide
  78.           mode, whether it's capable of doing synchronous transfer and if so,
  79.           what the period and offset is.
  80.  
  81.      The following options only apply to fibrechannel SCSI adapters:
  82.  
  83.      ----llll   Perform loop initialization.  During loop initialization, all
  84.           devices on the loop will attempt to acquire a target ID.  SGI
  85.           devices will attempt to get the ID they have been selected for,
  86.           either by settings on and position within an enclosure, or by
  87.           dials/switches on the device.  If multiple devices have the same ID
  88.           selection, only one device will get that ID.  Other devices will
  89.           attempt to acquire IDs not in already in use.
  90.  
  91.           TTTThhhhiiiissss ooooppppttttiiiioooonnnn mmmmaaaayyyy hhhhaaaavvvveeee aaaa ssssiiiiddddeeee eeeeffffffffeeeecccctttt ooooffff aaaabbbboooorrrrttttiiiinnnngggg ccccuuuurrrrrrrreeeennnntttt ccccoooommmmmmmmaaaannnnddddssss
  92.           oooouuuuttttssssttttaaaannnnddddiiiinnnngggg oooonnnn tttthhhheeee aaaaddddaaaapppptttteeeerrrr,,,, ssssoooo iiiitttt sssshhhhoooouuuulllldddd bbbbeeee uuuusssseeeedddd wwwwiiiitttthhhh ccccaaaarrrreeee....  TTTThhhheeee
  93.           ddddiiiisssskkkk ddddrrrriiiivvvveeeerrrr wwwwiiiillllllll ttttyyyyppppiiiiccccaaaallllllllyyyy rrrreeeeiiiissssssssuuuueeee tttthhhheeee aaaabbbboooorrrrtttteeeedddd ccccoooommmmmmmmaaaannnnddddssss,,,, bbbbuuuutttt tttthhhheeeerrrreeee
  94.           wwwwiiiillllllll bbbbeeee aaaa ppppeeeerrrrffffoooorrrrmmmmaaaannnncccceeee iiiimmmmppppaaaacccctttt wwwwhhhhiiiilllleeee ccccoooommmmmmmmaaaannnnddddssss aaaarrrreeee rrrreeeeiiiissssssssuuuueeeedddd....
  95.  
  96.  
  97.  
  98.      ----LLLL _t_a_r_g_e_t_I_D
  99.           Send LIPRST to the specified device and then perform loop
  100.           initialization.  This option is much like ----llll above, except that it
  101.           also requests that the device resets itself.  Not all devices will
  102.           honor the request.  RAID controllers typically don't while disk
  103.           drives typically do.  This option can be used in rare cases where a
  104.           device is not functioning properly, but is still able to complete
  105.           loop initialization and acquire a target ID.  For example, if a
  106.           drive gets timeouts on attempts to probe (using the ----pppp option
  107.           above), then this option may bring it back to working condition.  In
  108.           this respect, the ----LLLL option can be used for reasons similar to ----rrrr on
  109.           parallel SCSI buses.
  110.  
  111.      ----LLLL aaaallllllll
  112.           This option is like the ----LLLL option directly above, except that it
  113.           directs all devices to reset themselves.  Only devices that
  114.           implement FC-AL-2 or later will respond to this.  This option can be
  115.           used if a loop is malfunctioning, and it is suspected that one or
  116.           more devices may be causing the malfunction, but it isn't known
  117.           which.  RAID controllers typically don't honor the "self-reset"
  118.           function of the LIPRST
  119.  
  120.           TTTThhhheeee ----LLLL ooooppppttttiiiioooonnnnssss mmmmaaaayyyy hhhhaaaavvvveeee aaaa ssssiiiiddddeeee eeeeffffffffeeeecccctttt ooooffff aaaabbbboooorrrrttttiiiinnnngggg ccccuuuurrrrrrrreeeennnntttt ccccoooommmmmmmmaaaannnnddddssss
  121.           oooouuuuttttssssttttaaaannnnddddiiiinnnngggg oooonnnn tttthhhheeee aaaaddddaaaapppptttteeeerrrr,,,, aaaannnndddd iiiitttt iiiiffff tttthhhheeee ddddeeeevvvviiiicccceeee hhhhoooonnnnoooorrrrssss tttthhhheeee rrrreeeesssseeeetttt
  122.           ffffuuuunnnnccccttttiiiioooonnnn,,,, oooouuuuttttssssttttaaaannnnddddiiiinnnngggg ccccoooommmmmmmmaaaannnnddddssss ttttoooo iiiitttt wwwwiiiillllllll bbbbeeee ddddrrrrooooppppppppeeeedddd....  TTTThhhheeee ddddiiiisssskkkk
  123.           ddddrrrriiiivvvveeeerrrr wwwwiiiillllllll ttttyyyyppppiiiiccccaaaallllllllyyyy rrrreeeeiiiissssssssuuuueeee tttthhhheeee aaaabbbboooorrrrtttteeeedddd ccccoooommmmmmmmaaaannnnddddssss,,,, bbbbuuuutttt tttthhhheeeerrrreeee wwwwiiiillllllll
  124.           bbbbeeee aaaa ppppeeeerrrrffffoooorrrrmmmmaaaannnncccceeee iiiimmmmppppaaaacccctttt wwwwhhhhiiiilllleeee ccccoooommmmmmmmaaaannnnddddssss aaaarrrreeee rrrreeeeiiiissssssssuuuueeeedddd aaaannnndddd wwwwhhhhiiiilllleeee aaaa
  125.           ddddeeeevvvviiiicccceeee rrrreeeesssseeeettttssss....
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssccccssssiiiihhhhaaaa((((1111mmmm))))                                                          ssssccccssssiiiihhhhaaaa((((1111mmmm))))
  137.  
  138.  
  139.  
  140.      ----TTTT   Display a listing of targets connected to the fibrechannel adapter.
  141.  
  142.      ----wwww   This option will print the portname (sometimes known as the World
  143.           Wide Name) of the fibrechannel adapter.
  144.  
  145.      ----ssss   This option will print the link error statistics of the fibrechannel
  146.           adapter. The link error statistics will be displayed with an asterix
  147.           before adapter loop id (in case of loop topology) or before the
  148.           adapter portname (in case of fabric topology).
  149.  
  150.      ----SSSS _t_a_r_g_e_t_I_D
  151.           This option will print the link error statistics of the specified
  152.           fibrechannel target.  The target ID can be either unit number (in
  153.           case of loop topology) or nodename (in case of fabric topology).
  154.  
  155.      ----SSSS aaaallllllll
  156.           This option will the print link error statistics of the fibrechannel
  157.           adapter and all the targets connected to it.
  158.  
  159. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  160.      To reset parallel scsi bus 2, use one of these commands:
  161.  
  162.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_rrrr _2222
  163.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_rrrr _////_hhhh_wwww_////_ssss_cccc_ssss_iiii______cccc_tttt_llll_rrrr_////_2222_////_bbbb_uuuu_ssss
  164.  
  165.      To probe scsi bus 0, use one of these commands:
  166.  
  167.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_pppp _0000
  168.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_pppp _////_hhhh_wwww_////_ssss_cccc_ssss_iiii______cccc_tttt_llll_rrrr_////_0000_////_bbbb_uuuu_ssss
  169.  
  170.      To reset target 8 and then perform loop initialization on fibrechannel
  171.      bus 6, do the following:
  172.  
  173.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_LLLL _8888 _6666
  174.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_LLLL _8888 _////_hhhh_wwww_////_ssss_cccc_ssss_iiii______cccc_tttt_llll_rrrr_////_6666_////_bbbb_uuuu_ssss
  175.  
  176. FFFFIIIILLLLEEEESSSS
  177.      /hw/scsi_ctlr/*/bus     the scsi bus operation devices
  178.  
  179. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  180.      ioconfig(1M), scsicontrol(1M), scsiha(7M).
  181.  
  182. NNNNOOOOTTTTEEEE
  183.      This command is normally usable only by the superuser, because the
  184.      standard permissions of the devices in /_h_w/_s_c_s_i__c_t_l_r/* restrict access to
  185.      other users.
  186.  
  187.      With fibrechannel adapters, if a loop is broken after a system has been
  188.      operational, numerous attempts will be made to reinitialize the loop,
  189.      after which the host adapter driver will give up on the loop.  At this
  190.      point, if the hardware condition causing the broken loop is fixed (box of
  191.      drives powered back on, cable reinserted, etc.), the ----rrrr option should be
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ssssccccssssiiiihhhhaaaa((((1111mmmm))))                                                          ssssccccssssiiiihhhhaaaa((((1111mmmm))))
  203.  
  204.  
  205.  
  206.      used to re-establish loop operation.
  207.  
  208.      The source to this program is also shipped as sample source code in the
  209.      iiiirrrriiiixxxx____ddddeeeevvvv....ggggiiiiffffttttssss....ssssccccssssiiii subsystem as part of IDO.
  210.  
  211.      The Performance Co-Pilot (see _P_C_P(_1)) may be used to monitor SCSI
  212.      devices, however configuration changes by _s_c_s_i_h_a may not be
  213.      asynchronously detected.  If SCSI devices are being monitored,
  214.      _l_i_b_i_r_i_x_p_m_d_a(_5) may be notified and forced to reset using the command:
  215.  
  216.                > pmstore irix.xbow.switch 1
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.